home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / X11 / XSetWMProtocols.z / XSetWMProtocols
Encoding:
Text File  |  1998-10-30  |  5.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXSSSSeeeettttWWWWMMMMPPPPrrrroooottttooooccccoooollllssss((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXSSSSeeeettttWWWWMMMMPPPPrrrroooottttooooccccoooollllssss((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XSetWMProtocols, XGetWMProtocols - set or read a window's
  10.           WM__PROTOCOLS property
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           Status XSetWMProtocols(_d_i_s_p_l_a_y, _w, _p_r_o_t_o_c_o_l_s, _c_o_u_n_t)
  14.                 Display *_d_i_s_p_l_a_y;
  15.                 Window _w;
  16.                 Atom *_p_r_o_t_o_c_o_l_s;
  17.                 int _c_o_u_n_t;
  18.  
  19.           Status XGetWMProtocols(_d_i_s_p_l_a_y, _w, _p_r_o_t_o_c_o_l_s__r_e_t_u_r_n,
  20.           _c_o_u_n_t__r_e_t_u_r_n)
  21.                 Display *_d_i_s_p_l_a_y;
  22.                 Window _w;
  23.                 Atom **_p_r_o_t_o_c_o_l_s__r_e_t_u_r_n;
  24.                 int *_c_o_u_n_t__r_e_t_u_r_n;
  25.  
  26.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  27.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  28.  
  29.           _c_o_u_n_t     Specifies the number of protocols in the list.
  30.  
  31.           _c_o_u_n_t__r_e_t_u_r_n
  32.                     Returns the number of protocols in the list.
  33.  
  34.           _p_r_o_t_o_c_o_l_s Specifies the list of protocols.
  35.  
  36.           _p_r_o_t_o_c_o_l_s__r_e_t_u_r_n
  37.                     Returns the list of protocols.
  38.  
  39.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  40.           The _X_S_e_t_W_M_P_r_o_t_o_c_o_l_s function replaces the WM_PROTOCOLS
  41.           property on the specified window with the list of atoms
  42.           specified by the protocols argument.  If the property does
  43.           not already exist, _X_S_e_t_W_M_P_r_o_t_o_c_o_l_s sets the WM_PROTOCOLS
  44.           property on the specified window to the list of atoms
  45.           specified by the protocols argument.  The property is stored
  46.           with a type of ATOM and a format of 32.  If it cannot intern
  47.           the WM_PROTOCOLS atom, _X_S_e_t_W_M_P_r_o_t_o_c_o_l_s returns a zero
  48.           status.  Otherwise, it returns a nonzero status.
  49.  
  50.           _X_S_e_t_W_M_P_r_o_t_o_c_o_l_s can generate _B_a_d_A_l_l_o_c and _B_a_d_W_i_n_d_o_w errors.
  51.  
  52.           The _X_G_e_t_W_M_P_r_o_t_o_c_o_l_s function returns the list of atoms
  53.           stored in the WM_PROTOCOLS property on the specified window.
  54.           These atoms describe window manager protocols in which the
  55.           owner of this window is willing to participate.  If the
  56.           property exists, is of type ATOM, is of format 32, and the
  57.           atom WM_PROTOCOLS can be interned, _X_G_e_t_W_M_P_r_o_t_o_c_o_l_s sets the
  58.           protocols_return argument to a list of atoms, sets the
  59.           count_return argument to the number of elements in the list,
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXSSSSeeeettttWWWWMMMMPPPPrrrroooottttooooccccoooollllssss((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXSSSSeeeettttWWWWMMMMPPPPrrrroooottttooooccccoooollllssss((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           and returns a nonzero status.  Otherwise, it sets neither of
  75.           the return arguments and returns a zero status.  To release
  76.           the list of atoms, use _X_F_r_e_e.
  77.  
  78.           _X_G_e_t_W_M_P_r_o_t_o_c_o_l_s can generate a _B_a_d_W_i_n_d_o_w error.
  79.  
  80.      PPPPRRRROOOOPPPPEEEERRRRTTTTIIIIEEEESSSS
  81.           WM_PROTOCOLS
  82.                     List of atoms that identify the communications
  83.                     protocols between the client and window manager in
  84.                     which the client is willing to participate.
  85.  
  86.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  87.           _B_a_d_A_l_l_o_c  The server failed to allocate the requested
  88.                     resource or server memory.
  89.  
  90.           _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a
  91.                     defined Window.
  92.  
  93.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  94.           XAllocClassHint(3X11), XAllocIconSize(3X11),
  95.           XAllocSizeHints(3X11), XAllocWMHints(3X11), XFree(3X11),
  96.           XSetCommand(3X11), XSetTransientForHint(3X11),
  97.           XSetTextProperty(3X11), XSetWMClientMachine(3X11),
  98.           XSetWMColormapWindows(3X11), XSetWMIconName(3X11),
  99.           XSetWMName(3X11), XSetWMProperties(3X11),
  100.           XStringListToTextProperty(3X11)
  101.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.